home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 1501_600 / DISK1563 / DISK1563.ZIP / GUESSIT.DOC < prev    next >
Text File  |  1989-08-02  |  22KB  |  459 lines
  1. ***********************************************************************
  2. *                                                                     *
  3. *   GuessIT: A PC-Based Game to Guess Words or Phrases (Version II)   *
  4. *                                                                     *
  5. ***********************************************************************
  6.  
  7.           * tests your knowledge of words and facts
  8.           * can be adapted for different levels of difficulty
  9.           * can run flashcard quizzes on many subjects
  10.           * can use your personal word and fact lists
  11.           * comes with several challenging lists
  12.           * distributed as shareware (suggested contribution: $10)
  13.  
  14.                       Copyright Gary Perlman 1989
  15.                   Box 791, Worthington, Ohio 43085 USA
  16.  
  17. _______________________ QUICK START INSTRUCTIONS _______________________
  18.  
  19.         Put the floppy disk in drive A: and type the commands:
  20.             A:GUESSIT
  21.         Then, type letters to guess the letters in the words.
  22.  
  23.         For an idea of the quiz capabilities of GuessIT:
  24.             A:GUESSIT -L STATES.LST
  25.         When GuessIT asks you to Choose a Secret, type 3 (for Capital).
  26.         When GuessIT asks you to Choose a Hint, type 1 (for State name).
  27.         Then, type letters to guess the capital cities of states.
  28.  
  29. ____________________________ DISK CONTENTS _____________________________
  30.  
  31.         GUESSIT .EXE   The word/phrase guessing program
  32.         GUESSIT .DOC   This file describing GuessIT
  33.         ANIMALS .LST   Names of animals, groups, male, female, and young
  34.         AUTHORS .LST   Books and their authors
  35.         ELEMENTS.LST   Chemical elements and facts about them
  36.         LANGUAGE.LST   Months, weekdays, and numbers in several languages
  37.         PROVINCE.LST   Names, capitals, and confederation dates in Canada
  38.         NATIONS .LST   Nations and facts about them
  39.         SPORTS  .LST   Sports teams and where they play
  40.         STATES  .LST   U.S. states and facts about them
  41.         WORDS   .LST   A list of about 30,000 difficult words
  42.  
  43. __________________________ TABLE OF CONTENTS ___________________________
  44.  
  45.                 [1] WELCOME TO GuessIT
  46.                     [1.1] The Purpose of GuessIT
  47.                     [1.2] System Requirements
  48.                     [1.3] A Short History of GuessIT
  49.                     [1.4] The Shareware Concept
  50.  
  51.                 [2] GETTING STARTED WITH GuessIT
  52.                     [2.1] Installation Instructions
  53.                     [2.2] Running GuessIT
  54.  
  55.                 [3] CUSTOMIZING GuessIT WITH OPTIONS
  56.                     [3.1] The Secret List (-L)
  57.                     [3.2] Managing a Directory of Secret Lists (-D)
  58.                     [3.3] Controlling the Degree of Difficulty (-G, -C)
  59.                     [3.4] Hints in Secret Lists (-H, -T)
  60.                     [3.5] Creating a Custom BATCH File to Run GuessIT
  61.  
  62.                 [4] MORE ABOUT WORD, PHRASE, AND FACT LISTS
  63.                     [4.1] Lists Supplied with GuessIT
  64.                     [4.2] Advanced Information About GuessIT Lists
  65. [1] WELCOME TO GuessIT
  66.  
  67.     GuessIT is a word game that comes with lots of challenging lists
  68.     and tables of words and facts.  You can play it for a minute or an
  69.     hour, and you can make your own lists.
  70.  
  71.   [1.1] The Purpose of GuessIT
  72.  
  73.     GuessIT is based on a popular word-guessing game.  In GuessIT, a
  74.     template for a secret word or phrase is displayed on the screen, and
  75.     your goal is to guess all its letters.  With some lists of secrets,
  76.     you can get hints.  For example, to guess the French word "janvier"
  77.     your hint might be "January" or even "enero" (Spanish for January). 
  78.     Part of the playing "Arena" might look like this:
  79.  
  80.         Spanish: enero
  81.         French:  _______
  82.  
  83.     You only get a limited number of guesses, so you can't simply type
  84.     the whole alphabet.  As you make your guesses, the GuessIT display
  85.     keeps track of your progress.  The Scoreboard displays how many
  86.     guesses you are allowed and how many you have used.  The Scoreboard
  87.     also displays how many words or phrases you have tried and how many
  88.     you have guessed.  The Peanut Gallery makes superfluous but benign
  89.     comments, and also asks you if you want to try another secret.  The
  90.     Arena contains a record of the letters you have used and your
  91.     progress with the current secret.  If you run out of guesses, the
  92.     secret will be displayed in the Arena. 
  93.  
  94.   [1.2] System Requirements
  95.  
  96.     [1.2.1] CPU Requirements:  Any PC Compatible computer.
  97.  
  98.     [1.2.2] Software Requirements:  No other software needed.
  99.  
  100.     [1.2.3] Disk Requirements:  Minimal.  GuessIT can run directly from
  101.     a 360 Kbyte floppy disk.  You can install Guess-IT on your hard disk,
  102.     but that is not necessary for good performance.
  103.  
  104.     [1.2.4] Display Requirements:  Monochrome or color text displays.
  105.     If you are running GuessIT on an LCD or shaded "color" display, you
  106.     might find that the display is more readable if you run the program
  107.     in black and white (BW) mode; before running GuessIT, you may want
  108.     to run one of the following DOS commands.
  109.  
  110.         MODE BW80
  111.         MODE BW40
  112.  
  113.     GuessIT runs in 40 or 80 column modes, and uses the mode that it
  114.     detects when it starts.  If you prefer the 40 column mode, which is
  115.     nice for younger players, you might set up a BATCH file to set the
  116.     display mode to 40 column, run GuessIT, and reset back to 80 column:
  117.  
  118.         MODE BW40
  119.         GUESSIT
  120.         MODE CO80
  121.  
  122.     GuessIT displays directly to screen memory for high speed.  If this
  123.     causes "snow" then you should run GuessIT with the -V option to
  124.     turn off direct video display.
  125.  
  126.   [1.3] A Short History of GuessIT
  127.  
  128.     GuessIT grew out of a computer version of the game "hangman" in
  129.     which you guess the letters of words.  I did not like the violent
  130.     nature of hangman, which constructed gallows as you missed letters,
  131.     and I wanted to have a game that had a fun display.  The first
  132.     version of GuessIT accomplished this but I was not satisfied with
  133.     the ability to play GuessIT with children.  In GuessIT II, I added
  134.     hints so that children could guess an answer without using detailed
  135.     knowledge about the structure of words.  The ability to interchange
  136.     secrets and hints made GuessIT a good program for quizzes. 
  137.  
  138.   [1.4] The Shareware Concept
  139.  
  140.     GuessIT is distributed as shareware.  It is copyrighted, so you
  141.     should not modify it or sell it, but you can copy and distribute it
  142.     free of charge, provided that you distribute the program and this
  143.     document file intact.  If you use and enjoy GuessIT, then please
  144.     send $10 to me for my efforts.  I'll send you an upgrade of GuessIT
  145.     when it becomes available.
  146.  
  147.         Gary Perlman, Box 791, Worthington, Ohio 43085 USA
  148.  
  149. [2] GETTING STARTED WITH GuessIT
  150.  
  151.   [2.1] Installation Instructions
  152.  
  153.     You do not need to do any installation of GuessIT because you can
  154.     run GuessIT from a floppy disk.  You can also install GuessIT in any
  155.     directory on your hard disk.  If you install GuessIT in a directory
  156.     on your hard disk, you may want to edit a BATCH file to point to
  157.     the directory.
  158.  
  159.     To install GuessIT in a directory, say C:\GUESSIT, all you need to
  160.     do is create the directory and copy all the files on the floppy,
  161.     which, in the following example, is assumed to be in drive A:
  162.  
  163.         MKDIR  C:\GUESSIT
  164.         COPY  A:*.*  C:\GUESSIT
  165.  
  166.     GuessIT can read huge lists of words or phrases, but it only needs
  167.     one word or phrase at a time.  Disk access time is not a problem for
  168.     GuessIT so you can keep GuessIT on a floppy disk and save the
  169.     space used by the program and word lists.  Being able to run from a
  170.     floppy makes GuessIT an ideal game for people on the road with a
  171.     portable computer.  GuessIT is a good game to play on a laptop for
  172.     a few minutes while you wait for a plane. 
  173.  
  174.   [2.2] Running GuessIT
  175.  
  176.     [2.2.1] Starting GuessIT: If you are running GuessIT from a floppy or
  177.     you are in the directory where it is installed, you only need to type:
  178.  
  179.         GUESSIT
  180.  
  181.     See the section on options to customize the way GuessIT works.
  182.  
  183.     [2.2.2] The GuessIT Display: The top line shows the name of the game
  184.     and an instruction or two.  The top two windows are The Scoreboard and
  185.     the Peanut Gallery.  The bottom window is The Arena, where the guessing
  186.     takes place.  The bottom line shows the copyright and a 24-hour clock.
  187.  
  188.     [2.2.3] Guessing Letters: Depending on the secret list, you may have
  189.     hints available to help you guess the secret word.  For secret lists of
  190.     facts about things like nations or states, you will be shown a menu of
  191.     what you would like to guess (the secret) and what hint you would like
  192.     to be shown.  This setup, if applicable, is done in the Peanut Gallery.
  193.     Select from menus with digits.  After setup, you begin guessing letters.
  194.  
  195.     [2.2.4] Stopping GuessIT: You can quit GuessIT at any time by typing the
  196.     Escape (ESC) key.  At the end of a round of trying to guess a secret,
  197.     GuessIT asks in the Peanut Gallery if you want to try another.  Typing
  198.     the letter N here will also get you out. 
  199.  
  200. [3] CUSTOMIZING GuessIT WITH OPTIONS
  201.  
  202.     The following table is printed when you use the -O option when
  203.     starting GuessIT or when an option error is detected.  Explanations
  204.     of the options follow the table. 
  205.  
  206.     GuessIT: Guess the Word or Phrase [Version 2.0 (July 1989)]
  207.     -C chars       minimum characters in secrets   7
  208.     -D directory   directory holding lists . . .   A:\
  209.     -G guesses     maximum guesses per word  . .   7
  210.     -H hintchar    char between secret and hints   :
  211.     -L listfile    file of list of secrets . . .   words.lst
  212.     -O             print this option summary . .   NO
  213.     -T             print table of listfile . . .   NO
  214.     -V             turn off direct video output
  215.  
  216.   [3.1] The Secret List (-L)
  217.  
  218.     GuessIT comes with a list of over 30,000 words that will provide
  219.     many hours of challenge.  GuessIT can be adapted to any list of
  220.     words or phrases, provided that they are on one line that fits on
  221.     the display (for long phrases, 80 column display mode is best).  To
  222.     choose a new list of words or phrases for GuessIT, use the -L
  223.     option.  For example, you might have a list of quotes called
  224.     QUOTES.LST.  You could run GuessIT on this list with the command:
  225.  
  226.         GUESSIT -L QUOTES.LST
  227.  
  228.   [3.2] Managing a Directory of Secret Lists (-D)
  229.  
  230.     GuessIT comes with many secret lists (described later).  Instead of
  231.     requiring that you type in the whole pathname of a secret list (for
  232.     example, C:\GUESSIT\ANIMALS.LST), GuessIT lets you select the
  233.     directory where it will look for lists.  First, GuessIT looks in the
  234.     current directory for a list.  If it does not find it there, it looks
  235.     in the directory where the GuessIT program (GUESSIT.EXE) resides.
  236.     You can force GuessIT to look in a specific directory with the -D
  237.     option.  If GUESSIT.EXE is in one directory and your secret lists are
  238.     in C:\GUESSIT, you could access the list about nations with:
  239.  
  240.         GUESSIT -L NATIONS.LST -D C:\GUESSIT
  241.  
  242.     I save this information in a BATCH file, GI.BAT, to avoid retyping.
  243.     In the future, a menu of lists may be available from inside GuessIT.
  244.  
  245.   [3.3] Controlling the Degree of Difficulty (-G, -C)
  246.  
  247.     You can make it easier to guess a word or phrase by allowing more missed
  248.     letters to guess a secret.  The -G option will allow you to specify the
  249.     minimum number of guesses allowed.  You can also make it easier to
  250.     guess secrets by using longer secrets.  The -C option sets the minimum
  251.     number of characters in secrets, blank spaces included.  The more
  252.     letters in a secret, the easier it is to guess because it is more likely
  253.     that a guessed letter appears in the secret.  The following command will
  254.     allow 11 guesses for secrets with at least 9 characters:
  255.  
  256.         GUESSIT -G11 -C9
  257.  
  258.     GuessIT may not be able to find secrets if you ask for ones that are too
  259.     long.  The number of characters (-C) option is ignored in short lists.
  260.  
  261.   [3.4] Hints in Secret Lists (-H, -T)
  262.  
  263.     With some secret lists, GuessIT lets you see a hint about the
  264.     secret.  For example, you might make a list of famous events in
  265.     which the hint is the date on which the event took place.  The hint
  266.     for a secret follows the hint character (by default, the colon) as
  267.     shown below. 
  268.  
  269.         Battle of Hastings         : 1066
  270.         Signing of the Magna Carta : 1215
  271.         Columbus Discovers America : 1492
  272.  
  273.     If you make your own lists, you should use the colon (:) to separate
  274.     secrets from hints.  But if you have a list in about the right form,
  275.     you can use the -H option to tell GuessIT to use a different
  276.     character.  The next command says to use a comma.
  277.  
  278.         GUESSIT -L EVENTS.LST -H ,
  279.  
  280.     Many lists contain useful information that can be printed in a table
  281.     with the -T option.  All columns are aligned in the output, which
  282.     can be saved in a file with a command like the following:
  283.  
  284.         GUESSIT -T -L LANGUAGE.LST > LANGUAGE.TAB
  285.  
  286.     Tables can be very wide, so for printing, use small text!
  287.  
  288.   [3.5] Creating a Custom BATCH File to Run GuessIT
  289.  
  290.     Instead of typing long commands, you can save them in a BATCH file.
  291.     You have to know how to edit files to be able to create and modify
  292.     a BATCH file.  Any editor like LINEDIT is adequate for this.
  293.  
  294.     Before running GuessIT, you might want to put the screen in
  295.     40-column mode to get big letters on the display:
  296.  
  297.         MODE CO40
  298.  
  299.     For MONO screens, only 80-column mode is available.  For black and
  300.     white displays emulating color with shades, use MODE BW40.  After
  301.     running GuessIT, you would reset the screen with a command like:
  302.  
  303.         MODE CO80
  304.  
  305.     Now, assume that the GuessIT program, GUESSIT.EXE, is in C:\GAMES and
  306.     the lists (like WORDS.LST) are in D:\GUESSIT.  You can substitute your
  307.     own directories.  The following will point GuessIT to the right directory:
  308.  
  309.         C:\GAMES\GUESSIT -D D:\GUESSIT -G7 -C8
  310.  
  311.     To be able to set or reset options from the BATCH file, BATCH file
  312.     variables: %1, %2, ....  can be added to the commands in GI.BAT:
  313.  
  314.         MODE CO40
  315.         C:\GAMES\GUESSIT -D D:\GUESSIT -G7 -C8 %1 %2 %3 %4 %5
  316.         MODE CO80
  317.  
  318.     Place GI.BAT into a directory on your PATH command in AUTOEXEC.BAT.
  319.     Then, to run GuessIT on the list of facts on nations of the world,
  320.     allowing for 2 missed guesses, you would run:
  321.  
  322.         GI -L NATIONS.LST -G 2
  323.  
  324.     To avoid typing the -L and the .LST part, you could use:
  325.  
  326.         C:\GAMES\GUESSIT -D D:\GUESSIT -G7 -C8 -L %1.LST %2 %3 %4 %5
  327.  
  328.     and type:
  329.  
  330.         GI NATIONS
  331. [4] MORE ABOUT WORD, PHRASE, AND FACT LISTS
  332.  
  333.     Besides ordinary words, which are fun to guess, you can get a lot of
  334.     enjoyment and even some education from lists with hints in them. 
  335.     For example, a list of states or countries and their capitals can
  336.     help you learn about geography.  A list of chemical elements and
  337.     their symbols can help you learn some science.  A list of books and
  338.     their authors can help you learn about books you never read!  Famous
  339.     quotes, biblical names, famous physicists, historical events, .... 
  340.     The possibilities are unlimited.  Send your ideas for lists to me,
  341.     or better yet, send me your lists on a floppy! 
  342.  
  343.   [4.1] Lists Supplied with GuessIT
  344.  
  345.     Here are the example lists that come with GuessIT.  They provide a
  346.     rich set of challenges for all types of people, both young and old.
  347.     Although I have worked hard at getting the information in the lists
  348.     right, please don't stake anything of value on them.  By looking at
  349.     the contents of the files, it is easy to figure out how to modify
  350.     them or make your own new lists, but a detailed explanation follows.
  351.     When you run GuessIT with a list with hints, you will be asked (in
  352.     the Peanut Gallery) to choose from a menu the secret you want to
  353.     guess and the hint you want to receive.  By selecting the same hint
  354.     as the secret, you tell GuessIT to provide no hint.  With hints, it
  355.     is much easier to guess secrets, so I suggest you use less guesses.
  356.     Try running the following command to see how hints work.
  357.  
  358.         GUESSIT -L NATIONS.LST -G 2
  359.  
  360.     WORDS.LST: A sorted list of about 30,000 words.  This is the default
  361.     list, with no hints.  Each word in the list has at least five
  362.     letters, has only lower case letters, and any letter appears only
  363.     once in a word.  This list is a subset of a much larger list (almost
  364.     250,000 words) so many of the words are obscure.  You need to use
  365.     abstract knowledge of word structure to do well with this list. 
  366.  
  367.     ANIMALS.LST: A list of names of animals, groups, male, female, and
  368.     young.  Before you play this with your kids, you might want to think
  369.     about what a female dog (or wolf) is called. 
  370.  
  371.     AUTHORS.LST: A list of works containing the name of the author, the
  372.     title, and the date of authorship or publication. 
  373.  
  374.     ELEMENTS.LST: A list of chemical elements including the element
  375.     name, its symbol, its number, and its group in the periodic table. 
  376.  
  377.     LANGUAGE.LST: A list of months, weekdays, and numbers in several
  378.     languages:  English, French, Italian, Spanish, German, and Swedish.
  379.  
  380.     NATIONS.LST: A list of nations containing the name of the country,
  381.     the capital city, the location (for example, the continent), the
  382.     official or predominant languages, the money or currency used, and
  383.     the year it was admitted to the United Nations. 
  384.  
  385.     PROVINCE.LST: A list of Canadian provinces and territories, their
  386.     capitals, and the dates they joined Canada.
  387.  
  388.     SPORTS.LST: A list of professional sports teams with their team
  389.     names, division, and where they play. 
  390.  
  391.     STATES.LST: A list of U.S. states containing the name of the state,
  392.     the capital city, the two-letter postal abbreviation, the state
  393.     flower, the state bird, the state tree, the state nickname, and the
  394.     state motto (translated into English). 
  395.  
  396. [4.2] Advanced Information About GuessIT Lists
  397.  
  398.     There are two types of GuessIT lists: long lists with no hints and
  399.     short lists with hints.  Short lists with no hints are either too
  400.     hard or too boring.  Long lists with hints are a lot of work to
  401.     create.  A short list is one with less than 16000 characters.  Short
  402.     lists are loaded in their entirety into GuessIT when it starts, and
  403.     the order of the secrets is randomized.  Each secret in a short list
  404.     is presented only once (during a run of GuessIT).  In long lists,
  405.     the file of secrets is opened and a secret is randomly selected;
  406.     repeated presentations of the same secret is unlikely. 
  407.  
  408.     To simplify the explanation of lists, we'll work through an example
  409.     of a list that you could make for a child.  FAMILY.LST is a fun game
  410.     to play with your kid.  Make a list of family member names, with
  411.     hints that describe the member.  Here is a list that might be made
  412.     for Elroy Jetson:
  413.  
  414.         :NAME        : HINT
  415.         :Elroy       : Your Name
  416.         :George      : Your Dad
  417.         :Jane        : Your Mom
  418.         :Judy        : Your Sister
  419.         :Astro       : Your Dog
  420.         :Mr. Spacely : Dad's Boss
  421.  
  422.     The first line of the file describes the secret and hint.  You can
  423.     tell it is a description line because it begins with a punctuation
  424.     character (others might be a bar or comma).  Whatever is the
  425.     punctuation character, it will be used as the separator between
  426.     secrets and hints (over-riding the -H option).  These descriptions
  427.     (NAME, HINT) will be used in the GuessIT display, so they should be
  428.     eight characters or less.  If the description line is not present,
  429.     then the part before the hint character is used as the secret and
  430.     the part after is used as the hint.  When a description line is
  431.     used, secrets and hints are interchangeable; that is, you can be
  432.     shown "Astro" and have to guess "Your Dog".  When a description line
  433.     is present, GuessIT displays a menu of all the possible hints and
  434.     secrets in the Peanut Gallery and asks you to choose the secret and
  435.     the hint.  Menu selection is done with single number digits. 
  436.  
  437.     Secret lists can have more than just one secret and one hint.  For
  438.     example, in the STATES.LST file, there is the state name, its postal
  439.     abbreviation, its capital city, its state flower, and so on.  From a
  440.     state name (the hint) you might want to try to guess the state bird.
  441.     Going the other way is also possible, but there are some birds that
  442.     are the state bird of more than one state; the cardinal has been
  443.     chosen by seven states.  When there is more information about a
  444.     secret than just the hint you selected, you can see it by typing ?
  445.     and looking in the Peanut Gallery.  For example, if you were guessing
  446.     the state whose bird is the roadrunner, The Arena would contain:
  447.  
  448.         Bird:    Roadrunner
  449.         State:   ___ ______
  450.  
  451.     and an extra hint (typing ?) would fill the Peanut Gallery with:
  452.  
  453.         Capital :  Santa Fe
  454.         Abbrev  :  NM
  455.         Nickname:  Land of Enchantment
  456.         Motto   :  (It Grows as it Goes)
  457.         Flower  :  Yucca
  458.         Tree    :  Pinon
  459.